home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
u_man
/
cat1
/
glp.z
/
glp
Wrap
Text File
|
1998-10-30
|
29KB
|
528 lines
GGGGLLLLPPPP((((1111)))) PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss GGGGLLLLPPPP((((1111))))
NNNNAAAAMMMMEEEE
glp, printpanel - graphical lp printing command
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
ggggllllpppp [ X toolkitoption... ] [----cccc] [----dddddest] [----mmmm]
[----nnnnnumber] [----oooooption] [----ssss] [----tttttitle] [----wwww]
[----EEEE] [----FFFF] [----NNNN] [files]
PPPPrrrriiiinnnnttttPPPPaaaannnneeeellll and pppprrrriiiinnnnttttppppaaaannnneeeellll are aliases for ggggllllpppp
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
_g_l_p, also known as _P_r_i_n_t_P_a_n_e_l and _p_r_i_n_t_p_a_n_e_l, provides a graphical
interface to the _l_p(_1) printing command of the AT&T System V print
spooling system. The _g_l_p program accepts all _l_p command line options and
allows these options to be set interactively.
Similar to _l_p, _g_l_p permits multiple filenames to be specified on the
command line for printing. _g_l_p also permits its standard input to be
redirected so that the output of other programs can be printed using
redirection or piping. In addition, if _g_l_p is invoked without any
filenames specified and without a standard input redirection or pipe,
files for printing may be specified interactively on the _g_l_p panel.
CCCCoooommmmmmmmaaaannnndddd LLLLiiiinnnneeee OOOOppppttttiiiioooonnnnssss
The _g_l_p program supports all of the command line switches of the System V
_l_p command. An explanation of these switches is reproduced here for user
convenience. For more information refer to the _l_p(_1) man page. The _g_l_p
program supports additional command line switches to tailor print job
parameters and program display. The setting of options on the _g_l_p
command line will be reflected on the program's control panel graphical
display. As with the _l_p command, command line options that take arguments
must not have any whitespace between the option and its argument.
Further, due to possible conflicts between options relevant to the X
toolkit and options relevant to _g_l_p, all X toolkit options should be
specified using the full option name. For example, the X toolkit title
option should be specified as ----ttttiiiittttlllleeee.
The following System V _l_p command lines switches are supported:
----cccc Make copies in the spooling directory of the file(s) to be
printed. Normally, files will not be copied, but will be linked
whenever possible. If the ----cccc option is not given, then the user
should be careful not to remove any of the files before the
printing of the files has been completed. Also if the ----cccc option
has not been given, any changes to the files to be printed will
be reflected in the printed output.
----dddd_d_e_s_t Specifies the printer or printer class that is to perform the
printing. _d_e_s_t specifies the printer name or printer class
name. If the ----dddd option is not specified then the printer
selected will be the value of the LLLLPPPPDDDDEEEESSSSTTTT environment variable.
If LLLLPPPPDDDDEEEESSSSTTTT is not set, the system default printer will be
selected. If there is no system default printer, a list of all
PPPPaaaaggggeeee 1111
GGGGLLLLPPPP((((1111)))) PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss GGGGLLLLPPPP((((1111))))
printers known to the system is sorted alphabetically and the
first printer on the list will be used.
----mmmm Specifies that a mail message should be sent after the file(s)
have been printed. By default no mail is sent upon normal
completion of the print request.
----nnnn_n_u_m_b_e_r Specifies that _n_u_m_b_e_r of copies of the file(s) should be
printed.
----oooo_o_p_t_i_o_n Specifies a printer specific or printer class specific option
given by the string _o_p_t_i_o_n. Several _o_p_t_i_o_n strings may be
specified on the command line by using the ----oooo switch more than
once. The easiest method for setting printer specific options
is to use the MMMMoooorrrreeee OOOOppppttttiiiioooonnnnssss............ button in the action area or the
MMMMoooorrrreeee OOOOppppttttiiiioooonnnnssss............ item on the FFFFiiiilllleeee menu. If an option panel is
not available for a selected printer you must review the
printer interface script located in
/_v_a_r/_s_p_o_o_l/_l_p/_i_n_t_e_r_f_a_c_e/[_p_r_i_n_t_e_r _n_a_m_e] to obtain the complete
list of options for that printer. Typically, a printer will
accept the option "h" or "nobanner" to prevent the printing of
a banner page.
----ssss When a print job is submitted to the spooling system the job ID
is either displayed in a dialog box (graphical mode) or is
printed to standard output (non-graphical mode). If the ----ssss
option is specified, no job ID message is shown.
----tttt_t_i_t_l_e Specifies a title for the print job banner page.
----wwww Specifies that a message should be printed on the system
console after the files have been printed. If the user is not
logged in, a mail message will be sent.
The following command line switches are specific to _g_l_p:
----FFFF Normally, _g_l_p checks whether its standard input is coming from
a terminal or from a file. If _g_l_p is getting its standard input
from a file (i.e. the contents of a file have been piped or
redirected into _g_l_p), the program does not display the filename
entry area. Sometimes _g_l_p will not have its standard input
coming from a terminal but the filename entry area should be
displayed. This is the case when _g_l_p is invoked from the
Toolchest. The ----FFFF switch forces the display of the filename
entry area regardless of the state of the standard input. When
----FFFF is specified _g_l_p will take its input only from the filename
entry area even if a pipe or redirection has been specified on
the command line. The ----FFFF switch should be used when invoking
_g_l_p from the Toolchest, a Workspace FTR rule, or from any
program that will not associate a terminal with _g_l_p'_s standard
input.
PPPPaaaaggggeeee 2222
GGGGLLLLPPPP((((1111)))) PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss GGGGLLLLPPPP((((1111))))
----NNNN Runs the _g_l_p program in non-graphical mode. In this mode no
control panel is displayed and the program acts like the
standard System V _l_p command.
CCCCoooonnnnttttrrrroooollll PPPPaaaannnneeeellll UUUUssssaaaaggggeeee
The _g_l_p program presents a control panel that consists of up to five main
areas. These areas are the menu bar, filename entry area, printer
selection area, job option area and the action area. These areas are
described below.
MMMMeeeennnnuuuu bbbbaaaarrrr The application menu bar, located at the top of the _g_l_p panel,
provides access to all application functions. Commonly used
functions such as printing and option handling are also
accessible from buttons in the action area as described below.
The menu bar contains the following items:
FFFFiiiilllleeee
PPPPrrrriiiinnnntttt Submits the specified file(s) or standard input
data for printing by the spooling system. In
graphical mode a dialog will either confirm the
submittal of the print job or display an error
message. In non-graphical mode the print job ID
will be sent to the standard output (unless the
----ssss command line switch has been specified or the
nnnnooooJJJJoooobbbbIIIIdddd resource has been set to TTTTrrrruuuueeee). If no
errors have occurred submitting the print job to
the spooling system, the job submittal dialog
box will provide one or two buttons. If the
print job is submitted normally, both an _O_K and
an _E_x_i_t button will be displayed. The _O_K button
will dismiss the dialog and the _E_x_i_t button will
exit the _g_l_p program. If the job was submitted
from the standard input, only an _E_x_i_t button
will be displayed.
OOOOppppeeeennnn............ Selecting this menu item will bring up a file
selection dialog box. The file selected from the
dialog will be displayed in the filename entry
area. Note that the previous contents of the
filename entry area will be replaced by the
filename selected from the selection dialog.
MMMMoooorrrreeee OOOOppppttttiiiioooonnnnssss............
Many printers provide specialized, vendor-
specific options. The job option area provides a
text type-in field for specifying these printer
specific options. However, some printers provide
a graphical dialog for specifying the printer
specific options. If such a dialog is available
for the selected printer, the MMMMoooorrrreeee OOOOppppttttiiiioooonnnnssss............
menu item will have a normal appearance. If no
PPPPaaaaggggeeee 3333
GGGGLLLLPPPP((((1111)))) PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss GGGGLLLLPPPP((((1111))))
dialog is available, the item will appear grayed
out.
When the MMMMoooorrrreeee OOOOppppttttiiiioooonnnnssss............ item is selected, the
graphical options dialog for the selected
printer will be displayed. At the same time, the
printer specific options type-in field in the
job option area will be grayed out. When the
desired options have been selected on the option
dialog, the OOOOKKKK button on the dialog should be
pressed. This will remove the dialog from the
screen and will place text in the printer
specific options field in the job option area.
This text represents the options selected on the
graphical option dialog. An AAAAppppppppllllyyyy button is
also available for specifying options without
dismissing the dialog. Note that the type in
field in the job option area becomes ungrayed
and editable when the option dialog is no longer
displayed.
SSSSaaaavvvveeee OOOOppppttttiiiioooonnnnssss............
Brings up a dialog that allows spooler and
printer specific option settings to be saved to
disk. The spooler option settings are written to
the file ~/._g_l_p_r_c. Spooler options consist of
all settings in the job option area except the
printer specific options type-in values and the
number of copies. If printer specific options
have been modified for any listed printer, those
printers are listed on the dialog. These options
are stored on a per printer basis in files named
/_v_a_r/_s_p_o_o_l/_l_p/_s_e_t_t_i_n_g_s/<_p_r_i_n_t_e_r
_n_a_m_e>/<_u_s_e_r_n_a_m_e>. Note that the number of copies
is not saved to either file since this option is
more appropriately specified on the command line
or via the job option are control. Printer
specific options cannot be saved for printer
classes. If _g_l_p is run by either the user _r_o_o_t
or _l_p, the Save dialog permits the saving of
printer specific options for all users of the
selected printer.
QQQQuuuuiiiitttt Removes the _g_l_p panel from the screen and
terminates the program. Selecting this item
does not cancel any currently pending print
jobs.
OOOOtttthhhheeeerrrr TTTToooooooollllssss
PPPPaaaaggggeeee 4444
GGGGLLLLPPPP((((1111)))) PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss GGGGLLLLPPPP((((1111))))
PPPPrrrriiiinnnnttttSSSSttttaaaattttuuuussss
Selecting this menu item runs the _P_r_i_n_t_S_t_a_t_u_s
program for the currently selected printer.
HHHHeeeellllpppp
GGGGeeeennnneeeerrrraaaallll HHHHeeeellllpppp
Presents a dialog containing help information
for the _g_l_p program.
FFFFiiiilllleeeennnnaaaammmmeeee eeeennnnttttrrrryyyy aaaarrrreeeeaaaa
This area, located in the upper left portion of the _g_l_p panel,
provides a text entry field in which the names of files to be
printed can be entered. Multiple filenames may be specified
with each filename separated by whitespace. Bourne shell
filename meta characters such as '*' may be specified but job
control meta characters such as ';' are not permitted. If
filenames were specified on the _g_l_p command line, these
filenames will appear in the filename entry area when the panel
first appears on the screen. If the _g_l_p program standard input
has been redirected or piped from another programs output, the
filename entry area will not be displayed and all data to be
printed will come from the standard input.
PPPPrrrriiiinnnntttteeeerrrr sssseeeelllleeeeccccttttiiiioooonnnn aaaarrrreeeeaaaa
The left portion of the _g_l_p panel contains the printer
selection area. This area displays a list of the printers
available to the print spooling system. Any printer from the
list may be selected for printing. If a printer was specified
on the command line using the ----dddd option, the program will come
up with this printer selected on the list (assuming the printer
has been installed on the system). If a printer is not
specified on the command line, the system default printer will
be selected. Finally, if there is no system default printer,
the first printer on the list is selected.
If a system default printer exists, it will be displayed in
bold text on the printer list.
Printer status information can be obtained by double-clicking
on a printer on the list. This will bring up the _P_r_i_n_t_S_t_a_t_u_s
tool for the selected printer.
JJJJoooobbbb ooooppppttttiiiioooonnnn aaaarrrreeeeaaaa
This area on the right side of the program panel provides
controls for various print job options. Mostly these controls
duplicate the command line options of the _g_l_p and _l_p programs.
If print job options were specified on the _g_l_p command line,
they will be reflected in the initial setting of the
corresponding control in the job option area. Any option
settings specified in the ~/._g_l_p_r_c file will also be reflected
in the initial settings of the option controls with the
PPPPaaaaggggeeee 5555
GGGGLLLLPPPP((((1111)))) PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss GGGGLLLLPPPP((((1111))))
exception of the number of copies.
AAAAccccttttiiiioooonnnn aaaarrrreeeeaaaa
The action area is located at the bottom of the program panel
and contains the push buttons for commonly used program
operations. The functions performed by these buttons can also
be accomplished using the items in the menu bar. The action
area buttons have the following functions:
PPPPrrrriiiinnnntttt Submits the specified file(s) or standard input data
for printing by the spooling system. See the above
explanation of the PPPPrrrriiiinnnntttt menu item for detailed
information about this button.
MMMMoooorrrreeee OOOOppppttttiiiioooonnnnssss............
Displays the printer specific options panel for the
selected printer. See the above explanation of the
MMMMoooorrrreeee OOOOppppttttiiiioooonnnnssss............ menu item for detailed information
about this button.
SSSSaaaavvvveeee OOOOppppttttiiiioooonnnnssss............
Brings up a dialog that allows spooler and printer
specific option settings to be saved to disk. See the
above explanation of the SSSSaaaavvvveeee OOOOppppttttiiiioooonnnnssss............ menu item
for detailed information about this button.
SSSSeeeettttttttiiiinnnnggggssss FFFFiiiilllleeeessss
On startup the _g_l_p program will read the file ._g_l_p_r_c if it exists in the
user's home directory. This file is expected to contain a single line of
option switches for the _g_l_p program. The switches are the same as those
available on the command line except that the ----dddd, ----oooo, ----nnnn and ----NNNN options
must not be specified. Note that command line switches take the highest
precedence followed by the ._g_l_p_r_c file settings followed by the X
resource settings.
On startup the _g_l_p program also looks for files named
/_v_a_r/_s_p_o_o_l/_l_p/_s_e_t_t_i_n_g_s/<_p_r_i_n_t_e_r _n_a_m_e>/<_u_s_e_r_n_a_m_e> for each printer on the
available printer list. For each printer, if the <_u_s_e_r_n_a_m_e> file is not
found a file name _d_e_f_a_u_l_t_S_e_t_t_i_n_g_s will be read, if it exists. The file
is expected to contain a single line of printer specific options. The
options are listed as they would be typed into the printer specific
options type-in field in the job options area. Any additional lines in
the file will be ignored. Any printer specific options specified on the
command line will be appended to the options found in the settings file
for the initially selected printer. Note that printer specific options
are maintained on a per printer, per user basis. When a new printer is
selected from the list of available printers, any options specified for
that printer will be displayed in the job option area.
Spooler and printer specific options can be saved using either the SSSSaaaavvvveeee
OOOOppppttttiiiioooonnnnssss............ button in the action area or the SSSSaaaavvvveeee OOOOppppttttiiiioooonnnnssss............ item on the
FFFFiiiilllleeee menu.
PPPPaaaaggggeeee 6666
GGGGLLLLPPPP((((1111)))) PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss GGGGLLLLPPPP((((1111))))
WWWWiiiiddddggggeeeetttt HHHHiiiieeeerrrraaaarrrrcccchhhhyyyy
The following is an abbreviated widget hierarchy for _g_l_p.
glp (Glp)
menuBar (XmRowColumn)
printBox (PuiPrintBox)
The _g_l_p program is actually a wrapper around the PPPPrrrriiiinnnnttttBBBBooooxxxx widget
contained in the _l_i_b_p_r_i_n_t_u_i library. For detailed information on the
PrintBox and its resources refer to the man pages for _l_i_b_p_r_i_n_t_u_i(_3_X) and
_P_u_i_P_r_i_n_t_B_o_x(_3_X).
PPPPRRRROOOOGGGGRRRRAAAAMMMM RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
_g_l_p is written using the standard X toolkit and the Motif widget set. The
program accepts all standard Xt/Motif resources and command line options.
In addition to these resources the following resources are specific to
the _g_l_p program and may be specified by the user.
pppprrrriiiinnnntttteeeerrrrPPPPrrrrooooggggrrrraaaammmm (class PPPPrrrriiiinnnntttteeeerrrrPPPPrrrrooooggggrrrraaaammmm)
Specifies the full pathname of the program to be executed
when a printer on the available printer list is double-
clicked. The program will be passed the name of the
currently selected printer as an argument. If no program
is to be executed this resource should be specified with
no value (i.e. "Glp*printerProgram:"). By default the
_P_r_i_n_t_S_t_a_t_u_s program is executed.
nnnnooooJJJJoooobbbbIIIIdddd (class NNNNooooJJJJoooobbbbIIIIdddd)
Specifies whether the print job ID should be displayed
when a print job is successfully submitted to the spooling
system. If this resource is set to TTTTrrrruuuueeee (default), the job
ID will be displayed. If the resource is set to FFFFaaaallllsssseeee the
job ID will not be shown. If _g_l_p is in graphical mode, the
job ID will be displayed in a dialog box. If the program
is in non-graphical mode, the job ID will be printed on
the standard output.
NNNNOOOOTTTTEEEESSSS
1. The _g_l_p program submits print job to the AT&T System V print
spooler. The BSD spooling system is not currently supported.
2. The ----EEEE command line switch is no longer needed. The _g_l_p program will
silently ignore this switch.
SSSSEEEEEEEE AAAALLLLSSSSOOOO
lp(1), PrintStatus(1), libprintui(3X), PuiPrintBox(3X)
FFFFIIIILLLLEEEESSSS
/usr/lib/X11/app-defaults/Glp Program resource file
$HOME/.glprc Generic option file
PPPPaaaaggggeeee 7777
GGGGLLLLPPPP((((1111)))) PPPPrrrriiiinnnnttttiiiinnnngggg TTTToooooooollllssss GGGGLLLLPPPP((((1111))))
/var/spool/lp/settings/<printer name>/<username>
Per printer, per user printer specific
option files
/var/spool/lp/settings/<printer name>/defaultSettings
Per printer default printer specific
options
/var/spool/lp/gui_model Printer specific graphical option
dialogs
/var/spool/lp Directory for System V spooling system
PPPPaaaaggggeeee 8888